home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / gus / pfos2.zip / PFOS2.DOC next >
Text File  |  1993-07-20  |  9KB  |  183 lines
  1.                          PFOS2 V0.9b by Dave Mercier
  2.                          ---------------------------
  3.     INTRODUCTION
  4.     ============
  5.  
  6.     Why did I write this program which just looks like a clone of the
  7.     PLAYFILE utility included with the Gravis Ultrasound software?
  8.  
  9.     Because PLAYFILE doesn't work under OS/2 (at least version 2.0).
  10.     So every time I wanted to play or record a digital file, I had to
  11.     reboot and load up DOS. Writing this program means that I have one
  12.     less reason to have to boot DOS. There had been a few other sample
  13.     players written which worked under OS/2, but these were all very 
  14.     limited (No recording features, the length of the sample was limited
  15.     by the amount of DRAM on your Ultrasound, etc). As I was programming
  16.     this, I figured some other OS/2 users may benefit from it, so I decided
  17.     to release it.
  18.     
  19.     The PFOS2 just means 'Play file for OS/2'. I couldn't think of anything        
  20.     good to call it. Just remember that this is not an OS/2 program, it's
  21.     just a DOS program that won't crash the DOS box. I really would have
  22.     liked to make it an OS/2 program, but I lack the knowledge and resources
  23.     to make one (Maybe next year after I take some OS/2 programming courses).
  24.  
  25.  
  26.     SUMMARY OF FEATURES
  27.     ===================
  28.  
  29.     Here is a list of what functions of PLAYFILE that PFOS2 supports:
  30.  
  31.     Options:
  32.     -v#    Volume [0-4095]: 3500 is the default. The higher the setting
  33.            the louder the sound.
  34.  
  35.     -f#    Frequency [4000-44100]: Sets the frequency to play/record.
  36.            The default frequency setting is 22050Hz. Higher rates produce
  37.            a more accurate sample, but take more drive space. It is possible
  38.            to set a rate higher than 44100 or lower than 4000 when playing a 
  39.            file. This will just make a file play faster or slower, there
  40.            will be no increase in quality.
  41.  
  42.     -l#    Loop [1-65535]: Loop (number of times the file will play). The 
  43.            default is to play once. If you enter 0, the file will loop until
  44.            you press a key.
  45.  
  46.     -b#    Balance [0-15]: Like the balance on your stereo. The default
  47.            is 7, for equal sound distribution. Zero is the left 
  48.            speaker only, 15 is the right speaker only. This setting currently 
  49.            only works when playing mono files.
  50.  
  51.     -s     Stereo: Allows you to specify a stereo file. The default is mono.
  52.  
  53.     -r     Record: The default for PFOS2 is to play a digital file, but if 
  54.            you want to record, add -r to the command line.
  55.  
  56.     -n1/0  Enable or disable the line input.
  57.     -m1/0  Enable or disable the microphone input.
  58.            (Either 1, or both of these settings must be enabled to record
  59.             any sound at all. You can still use the for playback too.)
  60.  
  61.     -o#    Offset: Skip beginning portion of sound file by offset in bytes.
  62.  
  63.     -t#    Length: Specifies how many bytes of a sound file will be played.
  64.  
  65.  
  66.     At the moment there is no support for .WAV files or 16 bit sound. There
  67.     will never be any fancy looking interface that the new version of
  68.     PLAYFILE now has. Version 1.0 (if ever released) will support .WAV, 
  69.     16 bit playback, and an improved recording technique.
  70.  
  71.     The only difference between .WAV files and .SND files is the header.
  72.     You can always play a .WAV file by manually entering the frequency, etc.
  73.     The same pretty much goes for .VOC files. There are probably other types
  74.     of files that are similiar that I haven't tried. The moral of this is 
  75.     don't be afraid to try playing different formats of files. The worst that
  76.     could happen is you would get a headache from a horrible sound.
  77.  
  78.  
  79.     TIPS ON USING PFOS2 (or PLAYFILE)
  80.     =================================
  81.  
  82.     - Make sure your Hard Drive is defragmented if possible. On a fragmented
  83.       drive, the heads have to scramble around to find free blocks. Data may
  84.       be lost due to how long it takes the heads to find a free block.
  85.     - Make sure you have a few megs of Hard Drive space free when recording.
  86.       As you get to the end of free space on your drive, the blocks of free
  87.       space will get smaller and more scattered, causing the heads to take
  88.       longer to find a place to put the information.
  89.     - Don't run any disk compressors if possible. Disk compressors may slow
  90.       the process of writing or reading from the drive, causing loss of data.
  91.     - Use the fastest drive on your system, if possible. (Don't try and 
  92.       record to your floppy =))
  93.  
  94.     - Make sure you specify either -n1 or -m1 when recording. I've included
  95.       an idiot warning if you don't specify these. PLAYFILE didn't say 
  96.       anything if you forgot. I can't begin to count how many times I recorded
  97.       silence because of this. I also saw a lot of messages with people
  98.       thinking that their gus couldn't record because they didn't realize
  99.       they had to include these options.
  100.  
  101.     - You will probably get better sound recording with PLAYFILE under DOS
  102.       than using PFOS2. PFOS2's recording routines need to be fixed up to
  103.       remove the occasional 'pops' introduced. 
  104.  
  105.     - Rememeber that this is a DOS program, and is not tied to any OS/2
  106.       timers. PFOS2 will not get all the CPU time it needs, if you start
  107.       to do some heavy multitasking. This will cause some data to 'skip'
  108.       during playback and record. Your multitasking results will vary
  109.       from machine to machine. (I can do 14.4 d/l and word processing
  110.       while playing back a stereo 44.1khz file, with pretty much no problems)
  111.  
  112.     - If you are getting screwy sound when trying to record in stereo, try
  113.       changing the recording DMA channel. When I had mine on channel 1, the
  114.       stereo seperation would get badly messed up, with both PFOS2, and 
  115.       PLAYFILE, using both DOS and OS/2. I then changed the DMA channel to
  116.       3, and it worked great after that.
  117.  
  118.     - Don't use a 16 bit DMA channel under OS/2 if you get SYSTEM crashes
  119.       when using PFOS2.
  120.  
  121.  
  122.     SOME COMMENTS ABOUT OS/2 2.0 (2.1?) AND THE GUS
  123.     ===============================================
  124.  
  125.     - Don't use a 16 bit DMA channel when using OS/2. This will cause
  126.       an entire system crash. This is how it is on my system, however
  127.       it may work on your system. (I can use 16 bit DMA under DOS).
  128.  
  129.     - SBOS doesn't really work. I could only get version 1.22 or 1.23 
  130.       working using adlib mode (-o3) on certain applications. (I had a
  131.       couple of games working well). The newer versions of SBOS don't
  132.       work at all.
  133.  
  134.     - Playmidi, GUSMOD, and pretty much most of the other 3rd party GUS
  135.       software works under OS/2. MEGAEM won't and I get screwy things
  136.       happening with the Miles drivers. I hear of others being able to
  137.       use the Miles Drivers though (Maybe they are running 2.1?).
  138.  
  139.  
  140.     Well, that's about it for this document. Hope you people get some use 
  141.     out of this.
  142.  
  143.     If anyone has information about the .WAV header, or where I can get it 
  144.     from an FTP site, please EMAIL it to me at my internet address.
  145.  
  146.     If you find any bugs, or have any suggestions about anything else you
  147.     would like to see in this program, please EMAIL me. I'd appreciate any
  148.     comments on how this, or other software works under 2.1. I'd appreciate
  149.     a copy of OS/2 2.1 even more =). 
  150.  
  151.  
  152.     -----------------------------------------------------------------------
  153.     Internet address: a1140338@bcit.bc.ca
  154.         (This will change in september to something else)
  155.  
  156.     You can also reach me on the Gravis BBS network as Dave Mercier.
  157.     (I'm not affiliated with Gravis, so don't whine to them if my
  158.      program eats your computer.)
  159.     (By the way I won't be responsible if anything like that happens.)
  160.  
  161.     If all else fails, or you want to send me a million dollars, or hire
  162.     me for a really lucrative job, you can snail mail me at:
  163.  
  164.     105-3955 Smith Ave.
  165.     Burnaby, B.C.
  166.     Canada. V5G 2T8
  167.  
  168.     I guess this program is Public Domain, but if you want to make it share
  169.     ware and send me lots of money I won't stop you =).
  170.  
  171.     -----------------------------------------------------------------------
  172.  
  173.     P.S. - Look for something more interesting from me in the future.
  174.            Especially you musician types that are too poor to afford a
  175.            Multitrack.
  176.     
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.